home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3.2 / Ham Radio Version 3.2 (Chestnut CD-ROMs)(1993).ISO / packet / yapp / yapp.doc < prev    next >
Text File  |  1986-08-26  |  8KB  |  221 lines
  1.  
  2.  
  3.  
  4.               YAPP(tm) - Yet Another Packet Program 
  5.  
  6.            (C) Copyright 1986 by Jeff Jacobsen, WA7MBL
  7.                 Released For Public Distribution
  8.                        ALL RIGHTS RESERVED
  9.  
  10.  
  11.   Permission is granted to freely distribute this code, provided
  12. that this notice and the following disclaimer are included in
  13. their entirety and without modifications of any sort.  This work
  14. may not be sold, or modified and sold, or included with any other
  15. product to be sold, without the written permission of the author.
  16.  
  17.   No fee or compensation may be requested or received by any
  18. person or organization distributing this program, except by the
  19. author and/or K7PYK, the authorized distributor.
  20.  
  21. Disclaimer:
  22.  
  23.   No guarantees or warranties of any kind are expressed or
  24. implied.  This code is distributed "AS IS" without any warranty
  25. of any kind, either expressed or implied, including, but not
  26. limited to the implied warranties of merchantability and fitness
  27. for a particular purpose.  You are soley responsible for the
  28. selection of the program to achieve your intended results and for
  29. the results actually obtained.  Should the program prove defec-
  30. tive, you (and not the author) assume the entire cost of all
  31. necessary servicing, repair, or correction.
  32.  
  33.   Neither the author nor anyone else who has been involved in the
  34. creation, production or delivery of this program shall be liable
  35. for any direct, indirect, consequential or incidental damages
  36. arising out of the use or inability to use this program.
  37.  
  38.  
  39.                       Jeff Jacobsen, WA7MBL
  40.                           1400 E 900 N
  41.                        Logan, Utah  84321
  42.  
  43.  
  44. INTRODUCTION
  45.  
  46. YAPP(tm) was written to provide a terminal program for use in
  47. testing the WA7MBL BBS code.  To help provide funding for the
  48. continued development of the BBS code, it was decided to offer
  49. this program.  The BBS code will continued to be offered at no
  50. cost to the Sysops running it.
  51.  
  52. A contribution of $20 is asked of any users of YAPP who find it
  53. of value.
  54.  
  55. User feedback and registration is also encouraged.  Your comments
  56. and suggestions are welcomed.  The success of this method of
  57. distribution will determine whether future versions of YAPP will
  58. be distributed freely, or sold commercially.
  59.  
  60. Whether you make a contribution or not, you are encouraged to
  61. copy and distribute this program for the private, non-commercial
  62. use of others.
  63.  
  64. A copy of this program may be obtained by either sending $5 orby
  65. sending a blank, formatted disk together with an addressed,
  66. postage-paid return mailer to:
  67.  
  68.      Wes Morris, K7PYK
  69.      7422 E McKinley Street
  70.      Scottsdale, AZ  85257
  71.  
  72. A copy should also be available for downloading from Hamnet on
  73. Compuserve.
  74.  
  75. Contributions or user feedback may be sent to K7PYK, or
  76. directly to the author.
  77.  
  78.  
  79. HARDWARE REQUIREMENTS
  80.  
  81.  
  82. YAPP has been tested on an IBM PC, XT, AT, and a few
  83. compatibles.  Another version of YAPP (YAPP2) is available which
  84. uses an external resident I/O driver.  If you have an MS-DOS
  85. computer which does not use the standard IBM communication port
  86. locations, we may be able to help you adapt YAPP2 for your
  87. computer.
  88.  
  89. We recommend that your CONFIG.SYS file has a FILES parameter of
  90. at least FILES=10.  We uses FILES=20 and BUFFERS=20.
  91.  
  92.  
  93. COLOR MONITOR
  94.  
  95. If you are using a color monitor, you may change the colors used
  96. by editing the file YAPP.COL with a standard text editor.  See
  97. the file YAPPCOL.DOC for help with color values.
  98.  
  99.  
  100. TNC SET UP
  101.  
  102. This program uses hardware handshaking.  Your TNC should also be
  103. set for no parity and 8 bit words.  If you plan to do binary file
  104. transfer with YAPP (Yet Another Packet Prototcol) be sure that
  105. the TNC type is set correctly.  TNC type 0 is used for testing
  106. and does not send the commands to place the TNC into transparent
  107. mode.  TNC type 2 sends a break signal to place the TNC into
  108. command mode when necessary, while TNC type 1 uses the control-C
  109. method.  The most common problem is with cabling.  Be sure that
  110. your cable connects pins 1-8 and pin 20 for your serial port to
  111. your TNC.
  112.  
  113. To enable Hardware handshaking be sure the following are set:
  114.  
  115. START 0
  116. STOP  0
  117. XFLOW OFF
  118. XON   0
  119. XOFF  0
  120.  
  121. If you are using split screen mode, you will probably want:
  122.  
  123. FLOW OFF
  124. ECHO OFF
  125.  
  126. Other suggested parameters are included in TNC1.SET & TNC2.SET
  127. which should be included on the program diskette.
  128.  
  129.  
  130. COMMAND SUMMARY
  131.  
  132. The following commands are available from YAPP
  133.  
  134. F1    -  Display Help Menu
  135. F2    -  Toggle printer on/off
  136. F3    -  End File Capture 
  137. F4    -  Begin/Suspend File Capture 
  138. F5    -  Send text file
  139. F7    -  Send binary file
  140. F8    -  Receive binary file
  141. F9    -  DOS Gateway
  142.  
  143. Alt-B    Send Break
  144. Alt-C    Connect
  145. Alt-D    Directory
  146. Alt-E    Echo mode toggle
  147. Alt-F    Change Defaults (port, baud rate & TNC type)
  148. Alt-P    Strip 8th bit (parity) toggle
  149. Alt-S    Split Screen toggle
  150. Alt-T    Send Time & Date
  151. Alt-S    Split Screen toggle
  152. Alt-W    Write Scroll buffer to disk
  153. Alt-X    Exit  
  154.  
  155. All characters that scroll off the top are saved in the "scroll"
  156. buffer.  You may redisplay this buffer by pressing Home, PgUp, or
  157. the UpArrow.  Home starts from the oldest available screen in the
  158. buffer.  PgUp shows the previous screen, and UpArrow the previous
  159. line.  Once you are reviewing the scroll buffer, you may use PgDn
  160. or DownArrow to move forward through the buffer.  End will exit
  161. the review mode.  
  162.  
  163. There are times when you wish you had saved something that
  164. scrolls off the screen.  Alt-W will write the entire contents of
  165. the scroll buffer to disk.
  166.  
  167. When in split screen mode, all received characters are displayed
  168. on the top portion of the screen and everything you type appears
  169. at the bottom.  Only that appearing in the top portion will be
  170. saved in the scroll buffer.  If you wish to print or capture
  171. everything, you should turn off split screen mode.
  172.  
  173. You may also save information by pressing F4 to turn on capture
  174. mode.  This will write all received characters (or everything if
  175. you are not in split-screen mode) to a temporary disk file.
  176. Pressing F4 again will suspend the capture, or pressing F3 will
  177. complete the capture and ask you what to name the file.
  178.  
  179. F5 simply sends the contents of a file to the TNC.  You may use
  180. it to send commands to the TNC or messages.
  181.  
  182. F7 is used to send a binary file using the YAPP binary protocol.
  183. The receiving station must also be using the YAPP protocol.
  184.  
  185. F9 suspends the program and lets you run DOS commands.  To return
  186. to YAPP type EXIT at the DOS prompt.
  187.  
  188.  
  189.  
  190. NEW FEATURES
  191.  
  192. A connect directory has been added to this version.  Simply edit a
  193. text file called YAPP.DIR with the nickname you wish to use for a
  194. station (up to 6 characters) followed by the connect path.
  195.  
  196. For example:
  197.  
  198. Jeff   WA7MBL v WA7MXZ-1
  199. Wes    K7PYK
  200.  
  201. To connect, press Alt-C and you will be prompted for who you wish to
  202. connect to.  Enter the name, and the connect message will be sent to
  203. the TNC.
  204.  
  205.  
  206. If you have been capturing a file and decide not to save it, you may
  207. cancel the save at the time you close the capture by pressing the ESC
  208. key when prompted for the file name.
  209.  
  210.  
  211. It is now possible (although not recommended) to pass messages during a
  212. binary transfer.  The receiver may type messages to the sender easily.
  213. At present the send side only polls the keyboard occasionally, so the
  214. sender wont be able to type more than a few characters.  This is just an
  215. experimental addition to the binary transfer protocol.  Any text typed
  216. during the transfer will be lost if it hasn't been sent before the end
  217. of the transfer.  Also, attempting to send text during a file transfer
  218. with someone using an earlier version of YAPP will result in the transfer
  219. being aborted.
  220.  
  221.